NB: More recent documentation for Dyalog APL is available at https://docs.dyalog.com/20.0/.
Window Captions
The captions of the various windows that comprise the Dyalog Integrated Development Environment (IDE) are user-configurable and defined by entries in the Windows registry in the Captions subkey of the main Dyalog key.
Note that this only applies when the windows are floating (un-docked). When a window is docked Dyalog displays a fixed non-configurable caption.
Note also that the Captions subkey is not created by the interpreter; the user must create the subkey and the values.
Each entry is a string value whose name identifies the window as follows:
| Window Name | Description |
|---|---|
| Session | The main Dyalog APL session window |
| Editor | The Editor window |
| SysTray | The hint on Dyalog icons in the System Tray |
| MessageBox | The notification Message Box that is displayed in various circumstances; for example, when an object cannot be fixed by the Editor |
| Explorer | The Workspace Explorer tool |
| Rebuild Errors | The dialog box that is displayed if one or more objects cannot be re-instantiated when a workspace is loaded |
| Status | The Status window |
| Event Viewer | The Event Viewer |
| FindReplace | The Find/Replace dialog box |
| ExitDialog | The Exit dialog box that is displayed when the user closes the Session window |
| WSSearch | The Find Objects tool |
| Syserror | The Syserror Message Box |
Each string value should contain a mixture of your own text and keywords which are enclosed in braces, for example, {TITLE}. Keywords act like variables and are replaced at display time by corresponding values as described in the table below.
| Keyword | Value |
|---|---|
| {TITLE} | The window name shown in the first column of the previous table |
| {WSID} | Workspace ID (⎕WSID) |
| {NSID} | Current Namespace |
| {SNSID} | Current Namespace (short version) |
| {PRODUCT} | The name of the Dyalog product, for example, "Dyalog APL/W - 64" |
| {VER_A} | The main version number, for example, "14" |
| {VER_B} | The secondary version number, for example, "0" |
| {VER_C} | The tertiary version number (currently the internal revision number) |
| {PID} | The process ID |
| {CHARS} | "Classic" or "Unicode" |
| {BITS} | "32" or "64" |
| {XLOC} | The namespace currently being explored (Explorer only) |
For example, if the Registry contains .\Captions\Session whose value is:
My APL ({WSID}) Version {VER_A}.{VER_B}[{VER_C}] - {PID}
then the caption displayed in a new Dyalog APL Session window might be:
My APL (CLEAR WS) Version 14.0[20105] - 4616